home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3c / ttyname.z / ttyname
Encoding:
Text File  |  2002-10-03  |  3.9 KB  |  67 lines
  1.  
  2.  
  3.  
  4. ttttttttyyyynnnnaaaammmmeeee((((3333CCCC))))                                                        ttttttttyyyynnnnaaaammmmeeee((((3333CCCC))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _tttt_tttt_yyyy_nnnn_aaaa_mmmm_eeee, _tttt_tttt_yyyy_nnnn_aaaa_mmmm_eeee______rrrr, _iiii_ssss_aaaa_tttt_tttt_yyyy - find name of a terminal
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_tttt_dddd_llll_iiii_bbbb_...._hhhh_>>>>
  13.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_uuuu_nnnn_iiii_ssss_tttt_dddd_...._hhhh_>>>>
  14.  
  15.      _cccc_hhhh_aaaa_rrrr _****_tttt_tttt_yyyy_nnnn_aaaa_mmmm_eeee _((((_iiii_nnnn_tttt _ffff_iiii_llll_dddd_eeee_ssss_))))_;;;;
  16.  
  17.      _iiii_nnnn_tttt _tttt_tttt_yyyy_nnnn_aaaa_mmmm_eeee______rrrr _((((_iiii_nnnn_tttt _ffff_iiii_llll_dddd_eeee_ssss_,,,, _cccc_hhhh_aaaa_rrrr _****_bbbb_uuuu_ffff_,,,, _ssss_iiii_zzzz_eeee______tttt _bbbb_uuuu_ffff_llll_eeee_nnnn_))))_;;;;
  18.  
  19.      _iiii_nnnn_tttt _iiii_ssss_aaaa_tttt_tttt_yyyy _((((_iiii_nnnn_tttt _ffff_iiii_llll_dddd_eeee_ssss_))))_;;;;
  20.  
  21. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  22.      _tttt_tttt_yyyy_nnnn_aaaa_mmmm_eeee returns a pointer to a string containing the null-terminated path
  23.      name of the terminal device associated with file descriptor _f_i_l_d_e_s.
  24.      _tttt_tttt_yyyy_nnnn_aaaa_mmmm_eeee______rrrr is a reentrant version of _tttt_tttt_yyyy_nnnn_aaaa_mmmm_eeee where _b_u_f and _b_u_f_l_e_n give the
  25.      location and maximum size of where the resultant string should be placed.
  26.      The maximum length of the terminal name is {_T_T_Y__N_A_M_E__M_A_X}.  _ssss_yyyy_ssss_cccc_oooo_nnnn_ffff(3C)
  27.      may be used to determine this value.
  28.  
  29.      _iiii_ssss_aaaa_tttt_tttt_yyyy returns 1 if _f_i_l_d_e_s is associated with a terminal device, 0
  30.      otherwise.
  31.  
  32. FFFFIIIILLLLEEEESSSS
  33.      _////_dddd_eeee_vvvv_////_****
  34.  
  35. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  36.      _tttt_tttt_yyyy_nnnn_aaaa_mmmm_eeee returns a _NNNN_UUUU_LLLL_LLLL pointer if _f_i_l_d_e_s does not describe a terminal
  37.      device in directory _////_dddd_eeee_vvvv.
  38.  
  39.      _tttt_tttt_yyyy_nnnn_aaaa_mmmm_eeee______rrrr returns 0 on success or an error number on failure.  If _f_i_l_d_e_s
  40.      doesn't refer to a valid file descriptor, _EEEE_BBBB_AAAA_DDDD_FFFF is returned.  If _f_i_l_d_e_s
  41.      doesn't refer to a valid terminal device, _EEEE_NNNN_OOOO_TTTT_TTTT_YYYY is returned.  If the
  42.      value of _b_u_f_l_e_n is smaller than the length of the string to be returned
  43.      including the terminating null character, _EEEE_RRRR_AAAA_NNNN_GGGG_EEEE is returned.
  44.  
  45. NNNNOOOOTTTTEEEESSSS
  46.      The return value of _tttt_tttt_yyyy_nnnn_aaaa_mmmm_eeee points to static data whose content is
  47.      overwritten by each call.
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.